Summary

This PR integrates Netlify deployment configuration, Qdrant database support, and a comprehensive REST API for IDLHub, enabling one-click deployment, enhanced semantic search capabilities, and dynamic IDL loading/uploading from GitHub. The implementation uses the same ProgramMetadataEntry model from aldrin-labs/openSVM for full database compatibility.

Changes Made

Netlify Integration

• Created netlify.toml: Complete Netlify configuration with:
  • Redirects for /mcp and /install endpoints to the installation script
  • Security headers (X-Frame-Options, X-XSS-Protection, etc.)
  • Caching headers for optimal performance
  • SPA fallback routing
• Created NETLIFY.md: Comprehensive deployment guide covering setup, configuration, and troubleshooting
• Updated README.md: Added Deployment section with Netlify deploy button and instructions

Qdrant Integration with openSVM Compatibility

• Added @qdrant/js-client-rest dependency (v1.13.0)
• Created lib/qdrant.js: Qdrant database utilities using aldrin-labs/openSVM ProgramMetadataEntry model:
  • Vector size: 384 (matching openSVM)
  • Collections: program_metadata, token_metadata, idl_cache (matching openSVM structure)
  • Compatible with openSVM environment variables (QDRANT_URL, QDRANT_API_KEY, QDRANT_SERVER, QDRANT)
  • IDL stored as part of program metadata (in the idl field of ProgramMetadataEntry)
  • Semantic search and program discovery functions
• Created lib/types/program.ts: TypeScript types matching openSVM models:
  • ProgramMetadataEntry interface (exact match with openSVM)
  • IDL-related types (IDL, IDLInstruction, IDLAccount, IDLType)
  • Protocol types from index.json
• Created scripts/init-qdrant.js: Initialization script to populate Qdrant with program metadata including IDLs
• Created .env.example: Environment variable template for Qdrant configuration
• Added npm run qdrant:init script: Command to initialize Qdrant collections
• Created lib/README.md: Documentation explaining openSVM compatibility and usage

REST API for Dynamic IDL Management

• Added Express dependencies: express, cors, axios for API functionality
• Created api/server.js: Full-featured REST API server with:
  • POST /api/idl/load-from-github - Load IDL directly from any GitHub repository
  • POST /api/idl/upload - Upload IDL directly with JSON payload
  • GET /api/programs - List all programs with filtering (category, status, search)
  • GET /api/programs/:id - Get specific program details
  • GET /api/programs/:id/idl - Get IDL for specific program
  • GET /api/search - Semantic search using Qdrant
  • GET /api/qdrant/programs/:id - Get program from Qdrant with embedded IDL
  • GET /api/docs - Interactive API documentation
  • GET /health - Health check endpoint
• Created api/README.md: Complete API documentation with:
  • Endpoint reference and examples
  • Request/response formats
  • Error handling documentation
  • Deployment instructions
• Created api/QUICKSTART.md: Quick start guide with:
  • Installation instructions
  • Common use cases and examples
  • Node.js and browser integration examples
  • CI/CD integration examples
  • Troubleshooting guide
• Added npm scripts: npm run api:start and npm run api:dev to run the API server
• GitHub Integration: Automatic IDL fetching from public repositories with validation
• Automatic Registry Updates: IDL uploads automatically update index.json and store in Qdrant

Features Enabled

• ✅ One-click Netlify deployment with CDN distribution
• ✅ Automatic /mcp endpoint for installation script
• ✅ Semantic search across programs using Qdrant
• ✅ Similar program discovery
• ✅ Fast metadata queries with embedded IDLs
• ✅ Full compatibility with aldrin-labs/openSVM database model
• ✅ IDL storage integrated with program metadata (not separate collections)
• ✅ Shared Qdrant database can be used by both IDLHub and openSVM
• ✅ Dynamic IDL loading from GitHub repositories
• ✅ Direct IDL upload via REST API
• ✅ Programmatic access to IDL registry
• ✅ RESTful API with comprehensive documentation

Testing

• ✅ All 9 existing tests pass
• ✅ Qdrant module loads correctly
• ✅ No vulnerabilities in dependencies
• ✅ Netlify configuration validated
• ✅ ProgramMetadataEntry model validated with sample data
• ✅ API server loads without errors
• ✅ REST API endpoints validated

API Usage Examples

Load IDL from GitHub:

curl -X POST http://localhost:3000/api/idl/load-from-github \
  -H "Content-Type: application/json" \
  -d '{
    "owner": "coral-xyz",
    "repo": "anchor",
    "path": "tests/example.json",
    "programId": "example",
    "name": "Example Program",
    "category": "defi"
  }'

Upload IDL directly:

curl -X POST http://localhost:3000/api/idl/upload \
  -H "Content-Type: application/json" \
  -d '{
    "programId": "myprogram",
    "name": "My Program",
    "category": "defi",
    "idl": { "version": "0.1.0", "name": "my_program", "instructions": [] }
  }'

This implementation provides production-ready deployment infrastructure, enhanced search capabilities, and a comprehensive REST API for dynamic IDL management while maintaining full compatibility with the aldrin-labs/openSVM database model.

Fixes #11

Fixes #11

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.